Set up AutoPass License Servers

If you use the AutoPass License Server, users must use their network logon names as their StarTeam user names. This section explains the steps the administrator follows to set up a AutoPass license server.

For details on AutoPass License Server, see AutoPass License Server Help.

To set up an AutoPass License Server:

1. Install the AutoPass license server (the license server documentation explains how to do this).

2. AutoPass licenses are dual locked to StarTeam Server IPAddress and AutoPass lock code.

3. Communicate the AutoPass Lock code, and StarTeam Server IP Address to Micro Focus support.

4. As the StarTeam administrator, you should receive licensing file. Save the license files (this involves accessing the license web site and downloading the license files).

5. Use the license files to Install Licenses on AutoPass License Server by

6. In “License Management/Install Licenses”, select “Choose File(s)”

7. Configure the AutoPass license server for users (this is covered in AutoPass license server documentation).

8. Place a copy of the license file(s) in the /AutoPass/licenses folder, a subdirectory of the StarTeam Server <version> installation folder.

9. Configure StarTeam Server to connect to AutoPass license server by adding the following setting to starteam-server-configs.xml for each configuration. The setting will contain the URL to AutoPass license server, including the protocol (http or https)

   <option name="AutoPassURL" value="https://ipaddress:portNo"/> or:

   <option name="AutoPassURL" value="http://ipaddress:portNo"/>

   Example: <option name="AutoPassURL" value="http://127.0.0.1:5814"/>

10. Use the Server Administration tool to:

    • Change user names to network logon names.
    • Assign users to specific licenses by setting the license options.

When StarTeam Server starts, it checks for AutoPass license files and stores information about them in memory. It does not recognize new license until the next restart.

When a user logs in from a StarTeam client, the StarTeam Server tells the client what features are available to its user based on the license assigned to that user. If the user is assigned an AutoPass license from a license file, StarTeam server will connect to AutoPass License server to obtain a license of that type. If AutoPass License server no longer has this type of license, an exception will be returned indicating what the issue is. If the user license type is Unassigned, the user is not logged on and StarTeam Server returns an exception.

Back to top

Known issues with AutoPass License Server

• When StarTeam loses connection to AutoPass, StarTeam will allow users to login for a grace period. This can cause AutoPass to be out of sync with StarTeam ( since licenses cannot be released due to lack of connection to AutoPass). To fix this, restart StarTeam server, it will cause all licenses to be released.

• Multiple configurations on one machine must use the same AutoPass Server.

• StarTeam only supports AutoPass License Server 10.8 and higher.
• By default, AutoPass License Server installs on a secure port 5814, using a self-signed certificate, and enables only TLS 1.2. Some operating system might not support TLS1.2 , or might not allow self-signed certificates.

If you encounter Security exceptions while connecting to AutoPass License Server, either in browser or from StarTeam, we suggest to disable SSL and restart AutoPass . To disable SSL do the following:

Edit the server.xml, which can be found in “C:\Program Files\autopass\apls\apls\conf\” and update the following section with bold values, and restart “AutoPass License Server” service.

Back to top